home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / edisk21.arc / EDISK.DOC < prev    next >
Text File  |  1989-09-17  |  6KB  |  128 lines
  1.                                 16-Sep-89
  2.  
  3. EDISK.DOC: Info file for my fast, small, reset-resident RAM disk (Version 2.1)
  4.  
  5.    © 1988,1989 Volker A. Brandt (VBRANDT@DBNUAMA1.BITNET)
  6.      Non-profit copying and distributing permitted.
  7.      Please use this program only for humane and peaceful purposes.
  8.  
  9.  
  10.    EDISK is a resizeable, reset-resident RAM disk.  The original idea of making
  11. a RAM disk resident was taken from the Eternal2 program.  Absolutely everything
  12. else has changed.  Therefore, I distribute this program under my name, and will
  13. not distribute source.    This is mostly to control modifications.  Source is
  14. available upon request, if you really need it.
  15.  
  16. --------------------------------------------------------------------------------
  17.  
  18. EDISK features:
  19.  
  20.  - Works with 4 MB RAM.                        (V1.6)
  21.  - ECONF companion program configures RAM disk directly.       (V1.6)
  22.  - EDISK displays a message on restart.                (V1.6)
  23.  - Fast data transfer to/from even-address buffer, using "movem".  (V1.8)
  24.  - 'Real' boot sector, thus enabling disk editors etc. to run.       (V2.0)
  25.  - Driver fits into RAM disk boot sector, thus saving 512 bytes.   (V2.0)
  26.  - Configurable size (10 to 3900 KB), 16-bit FAT for speed.       (V2.0)
  27.  - 'Virtual 2nd FAT', ie. we save one FAT but pretend to have two. (V2.0)
  28.  - RAM disk volume label shows version and boot time.           (V2.1)
  29.  
  30.  
  31. How it works:
  32.  
  33.    Simply copy EDISK21.PRG into the \AUTO folder of your boot disk (floppy or
  34. hard disk.  Copy the configuring program, ECONF21.TOS, to any directory ON THE
  35. SAME DISK.  Configure the RAM disk for your needs (see below).    Then, boot the
  36. system as you always do.  You'll see the screen become white, then black again.
  37. This is a warm reset, and it's normal.    It's the way EDISK installs itself in
  38. the system.  This only happens after a cold boot.
  39.  
  40.    EDISK uses exactly the amount of memory you specify.  This is useful for a
  41. number of things.  Have a Mega2 and want to simulate a 1040 to test your new PD
  42. program?  Easy.  Just install a 1024KB EDISK, and your Mega2 behaves like a 1 MB
  43. machine.
  44.  
  45.    Due to the 'virtual FAT trick', the RAM disk actually provides more space
  46. than an equivalent 'real' disk.
  47.  
  48.  
  49. Notes:
  50.  
  51.  - EDISK must always be the first resident utility to be started.  If anot er
  52.    resident program precedes EDISK after a reset and it then changes the hard-
  53.    disk vectors, EDISK changes the hard disk vectors back to the original state
  54.    before reset.  The other resident program then becomes inaccessible.
  55.  - The current version of EDISK assumes that the memory to be used is zeroed
  56.    when EDISK is first installing the RAM disk.  This is really only necessary
  57.    for the FAT and directory sectors.
  58.  - There is an RTS ($4E75) coded as first instruction in the boot sector.  So
  59.    there is a small chance, *if* the boot sector is accidentally executed, that
  60.    the system can recover.  Also, the checksum offset is set to $FFFF.    Apart
  61.    from that, no special provisions are made.  So, don't try to boot from this
  62.    RAM disk. :-)
  63.  - All boot sector values are correct, except the entry for 'sectors per track'
  64.    (which is set to 9 = standard for floppy disks), to minimize GEMDOS
  65.    confusion.  The media byte is $F8, which is also used for some hard disk boot
  66.    sectors.
  67.  - The FAT size is optimally adjusted by the ECONF program.  The FAT is always
  68.    of 16-bit type; this results in a marked GEMDOS performance increase.
  69.  
  70.  
  71. ECONF, the configuration utility for "EDISK"
  72.  
  73. How it works:
  74.  
  75.    Run ECONF21.TOS.  It will search for EDISK21.PRG first in the current
  76. directory, then in the \AUTO folder on the CURRENT disk (ie. the disk ECONF21
  77. itself is run from).  If it can't find EDISK21.PRG, it will complain.  Once it
  78. has located EDISK21.PRG, it will display the current settings for drive and RAM
  79. disk, then prompt for a new drive id, and finally for a new size.  After you
  80. have entered them, the new values will be saved in the EDISK21 binary to take
  81. effect when the RAM disk is installed.
  82.  
  83.  
  84. Notes:
  85.  
  86.  - The user must enter the new disk size value using ONLY digits. Anything else,
  87.    including leading and trailing blanks, will be interpreted as an illegal
  88.    entry. This isn't very 'user-friendly', but easily programmed (in assembler,
  89.    at least).
  90.  - The values for 'minsize' and 'maxsize' are arbitrary. I think 10 KB minimum
  91.    size is reasonable.
  92.  - The program may be aborted by typing ^C at the second prompt without harmful
  93.    effects.
  94.  
  95.  
  96. EKILL21: The 'automatic killer utility' for "EDISK"
  97.  
  98. How it works:
  99.  
  100.    Place EKILL21.PRG in the \AUTO folder of any disk you want to boot from
  101. WITHOUT any RAM disk.  If a RAM disk is found, EKILL21 will remove it from main
  102. memory by forcing a cold boot.    If no RAM disk is found, EKILL21 will display
  103. the total amount of memory currently available.  Of course, users of TOS 1.4 can
  104. achieve the same effect by simply pressing Control-Alt-RightShift-Del ...
  105.  
  106.  
  107. Notes:
  108.  
  109.  - Be sure not to activate EDISK21.PRG and EKILL21.PRG at the same time.  Depen-
  110.   ding on circumstances, this might cause an endless loop in the boot process.
  111.  
  112. --------------------------------------------------------------------------------
  113.  
  114.    I have spent many hours on this program to make it as good as possible.  It
  115. is probably still not perfect.    If you find any bugs, quirks or any other
  116. undesirable behaviour, please notify me.  I have used previous versions of these
  117. programs since late 1987.
  118.  
  119.    Finally, if you cause any harm to anyone or anything (including yourself and
  120. your favourite data) using these programs, it's entirely your problem.
  121. I disclaim everything, including my existence.    ;-)
  122.  
  123.                                 Volker A. Brandt
  124.                                 Mörikestraße 6a
  125.                              D-5653 Leichlingen 1
  126.                                 West Germany
  127.  
  128.